home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglinterleavedarrays.z / fglinterleavedarrays
Encoding:
Text File  |  2002-10-03  |  8.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss - simultaneously specify and enable several
  10.      interleaved arrays
  11.  
  12.  
  13. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      SUBROUTINE ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss( INTEGER*4 _f_o_r_m_a_t,
  15.                                       INTEGER*4 _s_t_r_i_d_e,
  16.                                       CHARACTER*8 _p_o_i_n_t_e_r )
  17.  
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  20.      _f_o_r_m_a_t   Specifies the type of array to enable. Symbolic constants
  21.               GGGGLLLL____VVVV2222FFFF, GGGGLLLL____VVVV3333FFFF, GGGGLLLL____CCCC4444UUUUBBBB____VVVV2222FFFF, GGGGLLLL____CCCC4444UUUUBBBB____VVVV3333FFFF, GGGGLLLL____CCCC3333FFFF____VVVV3333FFFF,
  22.               GGGGLLLL____NNNN3333FFFF____VVVV3333FFFF, GGGGLLLL____CCCC4444FFFF____NNNN3333FFFF____VVVV3333FFFF, GGGGLLLL____TTTT2222FFFF____VVVV3333FFFF, GGGGLLLL____TTTT4444FFFF____VVVV4444FFFF,
  23.               GGGGLLLL____TTTT2222FFFF____CCCC4444UUUUBBBB____VVVV3333FFFF, GGGGLLLL____TTTT2222FFFF____CCCC3333FFFF____VVVV3333FFFF, GGGGLLLL____TTTT2222FFFF____NNNN3333FFFF____VVVV3333FFFF,
  24.               GGGGLLLL____TTTT2222FFFF____CCCC4444FFFF____NNNN3333FFFF____VVVV3333FFFF, and GGGGLLLL____TTTT4444FFFF____CCCC4444FFFF____NNNN3333FFFF____VVVV4444FFFF are accepted.
  25.  
  26.      _s_t_r_i_d_e   Specifies the offset in bytes between each aggregate array
  27.               element.
  28.  
  29. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  30.      ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss lets you specify and enable individual color,
  31.      normal, texture and vertex arrays whose elements are part of a larger
  32.      aggregate array element.  For some implementations, this is more
  33.      efficient than specifying the arrays separately.
  34.  
  35.      If _s_t_r_i_d_e is 0, the aggregate elements are stored consecutively.
  36.      Otherwise, _s_t_r_i_d_e bytes occur between the beginning of one aggregate
  37.      array element and the beginning of the next aggregate array element.
  38.  
  39.      _f_o_r_m_a_t serves as a ``key'' describing the extraction of individual arrays
  40.      from the aggregate array.  If _f_o_r_m_a_t contains a T, then texture
  41.      coordinates are extracted from the interleaved array.  If C is present,
  42.      color values are extracted. If N is present, normal coordinates are
  43.      extracted.  Vertex coordinates are always extracted.
  44.  
  45.      The digits 2, 3, and 4 denote how many values are extracted.  F indicates
  46.      that values are extracted as floating-point values.  Colors may also be
  47.      extracted as 4 unsigned bytes if 4UB follows the C.  If a color is
  48.      extracted as 4 unsigned bytes, the vertex array element which follows is
  49.      located at the first possible floating-point aligned address.
  50.  
  51. NNNNOOOOTTTTEEEESSSS
  52.      ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss is available only if the GL version is 1.1 or
  53.      greater.
  54.  
  55.      If ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss is called while compiling a display list, it is
  56.      not compiled into the list, and it is executed immediately.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      Execution of ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss is not allowed between the execution of
  75.      ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ffffggggllllEEEEnnnndddd, but an error may or
  76.      may not be generated. If no error is generated, the operation is
  77.      undefined.
  78.  
  79.      ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss is typically implemented on the client side.
  80.  
  81.      Vertex array parameters are client-side state and are therefore not saved
  82.      or restored by ffffggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb and ffffggggllllPPPPooooppppAAAAttttttttrrrriiiibbbb.  Use ffffggggllllPPPPuuuusssshhhhCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb
  83.      and ffffggggllllPPPPooooppppCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb instead.
  84.  
  85. EEEERRRRRRRROOOORRRRSSSS
  86.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _f_o_r_m_a_t is not an accepted value.
  87.  
  88.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _s_t_r_i_d_e is negative.
  89.  
  90.  
  91. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  92.      ffffggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ffffggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss, ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss,
  93.      ffffggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ffffggggllllEEEEnnnnaaaabbbblllleeeeCCCClllliiiieeeennnnttttSSSSttttaaaatttteeee, ffffggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrr, ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr,
  94.      ffffggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ffffggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr, ffffggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.